Qt5.6文档翻译：QSystemTrayIcon类,QSystemTrayIcon Class

QSystemTrayIcon 类，为应用程序提供了一个可显示在系统托盘区的图标。 详细说明……

详细说明

QSystemTrayIcon 类，为应用程序提供了一个可显示在系统托盘区的图标。

现代操作系统通常都会在桌面上提供一个特定区域，名为 系统托盘 或 通知区域 ，长时间运行的应用程序可在该区域显示图标及简短的消息。

QSystemTrayIcon 类可在以下平台上使用：

• •. X11 中所有实现了 http://standards.freedesktop.org/systemtray-spec/systemtray-spec-0.2.html freedesktop.org XEmbed 系统托盘标准的窗口管理器及独立的托盘系统。

• •. 所有实现 了D-Bus  http://www.freedesktop.org/wiki/Specifications/StatusNotifierItem/StatusNotifierItem 标准的X11 桌面环境，包括最近版本的KDE。

要想检查用户桌面上是否存在系统托盘的话，则调用 QSystemTrayIcon::isSystemTrayAvailable ()这个静态函数。

要想添加一个系统托盘图标条目，则创建一个 QSystemTrayIcon 对象，调用 setContextMenu () 以便为该图标提供一个上下文菜单，然后调用 show () 以使得它在系统托盘中变得可见。 在任何时候，可使用 showMessage ()来显示状态通知消息 ("气 泡 消息") 。

如果 ，在系统托盘图标 被 构造时，系统托盘还不可用，但是，在稍后变得可用了，那么， 在该图标本身被设置成可见（ visible ）的情况下， QSystemTrayIcon 会自动为该应用程序添加一个系统托盘图标条目。

当用户激活该图标时，会发射 activated ()信号。

在 X11 中， 当用户请求查看提示文字 （tooltip）时， 该 QSystemTrayIcon 实例 会接收到一个 QHelpEvent 事件 ， 其类型是 QEvent::ToolTip 。另外 ， QSystemTrayIcon 还能够接收到滚轮事件，类型为 QEvent::Wheel 。 这些东西，在其它平台是不被支持的。

参考 QDesktopServices 、 QDesktopWidget 、 桌面整合 和 系统托盘图标示例 。

成员类型文档

enum QSystemTrayIcon::ActivationReason

参考 activated () 。

enum QSystemTrayIcon::MessageIcon

参考 QMessageBox 。

属性文档

icon  :  QIcon

这个属性，即是系统托盘图标的图片。

在X11中，最佳的图标图片尺寸是22x22。必要的情况下，图标会被缩放到适当的尺寸。

访问函数：

toolTip  :  QString

这个属性，即是该系统托盘图标条目的工具提示文字。

在某些系统中，工具提示的长度是有限制的。在必要的情况下，工具提示文字会被截断。

访问函数：

visible : bool

将这个属性设置为真（true），或者调用 show ()，都会使得该系统托盘图标变为可见； 将这个属性设置为假（false），或者调用 hide ()，就能够隐藏它。

访问函数：

成员函数文档

QSystemTrayIcon:: QSystemTrayIcon ( QObject  * parent  = Q_NULLPTR)

构造 一个 QSystemTrayIcon 对象，并且指定亲代对象为 parent 。

图标最初处于不可见状态。

参考 visible 。

QSystemTrayIcon:: QSystemTrayIcon (const  QIcon  & icon ,  QObject  * parent  = Q_NULLPTR)

构造 一个 QSystemTrayIcon 对象，并且指定图标为 icon ，指定亲代对象为 parent 。

图标最初处于不可见状态。

参考 visible 。

QSystemTrayIcon::~QSystemTrayIcon()

[ signal ] void  QSystemTrayIcon:: activated ( QSystemTrayIcon::ActivationReason reason )

当用户激活这个系统托盘图标条目时，会发射此信号。 reason 表示 的是此次激活的原因。 QSystemTrayIcon::ActivationReason 枚举 出了所有可能的原因。

参考 QSystemTrayIcon::ActivationReason 。

QMenu  *QSystemTrayIcon:: contextMenu () const

返回这个系统托盘图标条目当前所关联的上下文菜单。

参考 setContextMenu () 。

[virtual protected] bool  QSystemTrayIcon:: event ( QEvent  * e )

对 QObject::event ()进行了覆盖。

QRect  QSystemTrayIcon:: geometry () const

返回这个系统托盘图标条目在屏幕坐标系中的几何属性。

这个函数是从Qt 4.3 开始引入的。

参考 visible 。

[slot] void  QSystemTrayIcon:: hide ()

参考 show () 和 visible 。

[static] bool  QSystemTrayIcon:: isSystemTrayAvailable ()

如果系统托盘当前 不可用，但是稍后变为可用了，那么， 在该系统托盘图标条目本身是可见（ visible ）状态的情况下， QSystemTrayIcon 会自动向系统托盘中添加一个图标条目。

[signal] void  QSystemTrayIcon:: messageClicked ()

如果之前通过 showMessage ()显示 的消息 被用户点击了，那么，会发射这个信号。

注意 ：如果用户点击一个正在显示气泡消息的托盘图标，那么，此信号也会被发射。

参考 activated () 。

void  QSystemTrayIcon:: setContextMenu ( QMenu  * menu )

将指定的菜单 menu 设置为此系统托盘图标的上下文菜单。

当用户点击对应的鼠标按钮，以要求显示此系统托盘图标的上下文菜单时，就会弹出此处指定的菜单。

注意 ：系统托盘图标并不接收该菜单的所有权。妳必须确保它会在适当的时机被删除，例如，在创建时就为它指定一个适当的亲代对象。

参考 contextMenu () 。

[slot] void  QSystemTrayIcon:: show ()

参考 hide () 和 visible 。

[slot] void  QSystemTrayIcon:: showMessage (const  QString  & title , const  QString  & message , QSystemTrayIcon::MessageIcon icon  = QSystemTrayIcon::Information,  int millisecondsTimeoutHint  = 10000)

为这个系统托盘图标条目显示一个气泡消息，并且指定标题 title 、消息内容 message 、图标 icon 和超时时间 millisecondsTimeoutHint 。 title 和 message必须是纯文本字符串。

消息 可被用户点击； 当此事发生时，会发射 messageClicked ()信号。

注意，消息的显示情况最终是由系统配置和用户的设置来决定的，该消息甚至可能根本不会被显示出来。因此，对于重要信息，不应当仅仅依赖这种手段来进行显示。

自Qt 5.2 开始，被变更成一个信号槽。

此函数是从Qt 4.3 开始引入的。

参考 show () 和 supportsMessages () 。

[static] bool  QSystemTrayIcon:: supportsMessages ()

参考 showMessage () 。

未知美人